home *** CD-ROM | disk | FTP | other *** search
/ ClipArt Heaven 2 / ClipArt Heaven 2.iso / utility / mvp / mvpshare.doc < prev    next >
Text File  |  1991-02-13  |  14KB  |  443 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                      MUSIC, VOICE & PICTURES
  11.                            Version 1.0
  12.                            14-Feb-1991
  13.  
  14.  
  15.  
  16.  
  17.  
  18.                             SHAREWARE
  19.  
  20. Copyright (c) 1991 - Data Assist, Inc., All Rights Reserved. 
  21.  
  22. MVP is a command language for creating musical slide-shows for
  23. use with the AdLib (tm) and Sound Blaster (tm) music boards.
  24. (Voice commands are supported only on the Sound Blaster card) 
  25.   
  26. MVP is not free!  MVP is distributed as Shareware and you must
  27. register the program if you continue to use it after a 10 day
  28. evaluation period. 
  29.  
  30. Registration is only $35; You will receive:
  31.  
  32.      An update disk with a registered version of MVP.
  33.      A PCX image capture program. (ARGUS)
  34.      A PCX image viewing program. (VIEWPCX)
  35.      A PLB library utility. (MAKEPLB)
  36.      Special access to our BBS.
  37.      A FREE color scan (if you register before 7/1/91)
  38.      Discounts on High-Resolution color image scanning.
  39.  
  40. For more information about the MVP package, please call or write:
  41.  
  42.      Data Assist, Inc.
  43.      P. O. Box 26114
  44.      Columbus, OH  43226
  45.      Tel: 614-888-8088
  46.      BBS: 614-888-8056
  47.  
  48. Please do not call us for technical support unless you have a
  49. registration number. Unregistered users are asked to call our BBS
  50. for technical assistance.
  51.  
  52. Note: For purposes of this document, MVP refers to the MVPSHARE
  53. program. Registered users will receive the MVP program which does
  54. not have the closing Shareware screen.   
  55.  
  56.  
  57.  
  58.                            INTRODUCTION
  59.  
  60. MVP is a package used to create animated slide-shows complete
  61. with music, voice and pictures. To use this program, you must
  62. have either an AdLib or Sound Blaster music card, and either a
  63. CGA, EGA, MCGA, or VGA video graphics adapter.
  64.  
  65. MVP accepts standard AdLib music files and is compatible with
  66. both the AdLib and Sound Blaster music cards. 
  67.  
  68.  
  69.                            REQUIREMENTS
  70.  
  71. Music:  An Adlib or Sound Blaster music board is required to play
  72. ROL music files. The AdLib music driver (SOUND.COM) or the Sound
  73. Blaster music driver (SB-SOUND.COM) must be loaded into the
  74. computer prior to running MVP. You must also insure that a bank
  75. file, such as STANDARD.BNK, is in the current directory. 
  76.  
  77. Voice:  A Sound Blaster card is required in order to play
  78. digitized sound files. The VPLAY.EXE is also required in order to
  79. use the VPLAY command. VOUT.EXE is required in order to use the
  80. VOUT command.
  81.  
  82. Pictures:  A CGA, EGA, MCGA or VGA graphics display is required. 
  83.  
  84. Memory:  MVP requires 384K bytes of memory. Additional memory may
  85. be required for larger VGA pictures.
  86.  
  87. Disk:  A Hard disk is not required but is highly recommended. 
  88.  
  89.  
  90.  
  91.                  USING YOUR PHOTOGRAPHS WITH MVP
  92.  
  93. Playing music and showing graphics is not new to computers. But
  94. with MVP, you control what pictures are displayed and what music
  95. is played!
  96.  
  97. Imagine the possibilities...
  98.  
  99. * Birthday Parties; Ideal for any member of the family.
  100.  
  101. * Children Music; Show pictures of your kids while music plays! 
  102.  
  103. * Rock Music; Display pictures of the band while enjoying music.
  104.  
  105. * Religious Music; Ideal for Bible classes and meetings.
  106.  
  107. * Classical Music; Show pictures of your favorite composers.
  108.  
  109. * Advertising, Promotion and Trade Shows; Attracts attention.
  110.  
  111. With MVP creating musical slide shows is now fun and easy!
  112.  
  113.  
  114.                 SENDING PHOTOGRAPHS TO BE SCANNED
  115.  
  116. Data Assist provides a high-resolution color image scanning
  117. service. We can convert your photographs into graphics files that
  118. you can use with MVP. In addition, we can scan multiple images
  119. using the same color palette, so MVP can easily move from one
  120. picture to another.
  121.  
  122. We use the best color scanning hardware and software available.
  123. In addition to MVP, we can also scan images for other graphics
  124. packages. For the best results please send standard size color
  125. prints. Your photo should be 8" x 10" or smaller, but no smaller
  126. than wallet size. The prints developed by Fotomat, K-mart or your
  127. local drug store will scan very well.  
  128.  
  129. When selecting a picture to send, try to select a clear, colorful
  130. picture. Do NOT send 35mm slides-- get a print made first. For
  131. full screen images, your photograph should be wider than it is
  132. tall. Otherwise, we will need to crop the image in order to
  133. create a full screen VGA or EGA image. 
  134.  
  135. Note:  All prints will be returned after processing. However,
  136. Data Assist, Inc. ASSUMES NO LIABILITY for any loss or damage to
  137. your property during shipping or processing. 
  138.    
  139. Please allow 2 weeks for processing. Contact Data Assist for
  140. quantity pricing. 
  141.  
  142.  
  143.  
  144.                       OPERATING INSTRUCTIONS
  145.  
  146. MVPSHARE is run from the DOS command prompt by entering the
  147. command MVPSHARE. The program requires one command parameter
  148. which is the name of a MVP program command file.
  149.  
  150. MVPSHARE
  151.  
  152. Syntax: MVPSHARE  file.cmd  option
  153.  
  154. MVPSHARE will load the program (file.cmd) into memory and will
  155. begin executing the embedded music, voice and graphics commands. 
  156.  
  157. The only option currently available is "-M". This option
  158. instructs MVP to suppress the playing of music. This option is
  159. handy while testing your program or when running your program on
  160. a computer without a sound card.
  161.  
  162.                     CREATING MVP COMMAND FILES
  163.  
  164. You can create your own MVP command files by using any standard
  165. DOS text file editor or word processor. If you are using a word
  166. processing program, you must be sure to save the MVP command file
  167. as a text file. 
  168.  
  169. Note:  Some word processing programs, such as Word Perfect, do
  170. not normally save documents as DOS text files. Please refer to
  171. your word processors manual for assistance in creating a DOS text
  172. file.
  173.  
  174.  
  175.  
  176.                            MVP COMMANDS
  177.  
  178. MVP command files contain commands used to play music and sound
  179. files as well as commands to load and display computer graphics.
  180. Commands must begin in the first position of the text line. Do
  181. not indent or use tabs characters when creating MVP program text
  182. files.
  183.  
  184. The MVP commands are listed here in alphabetical order:
  185.  
  186. !
  187.  
  188. Syntax:  ! Comment
  189.  
  190. Comment lines are ignored by MVP.
  191.  
  192.  
  193. BANK
  194.  
  195. Syntax:  BANK  Bank-file
  196.  
  197. Bank-file is the name of the AdLib instrument bank file. The
  198. Bank-file is used by the ROL command to load musical instruments.
  199.  
  200. Example:  BANK STANDARD.BNK
  201.  
  202.  
  203. EFFECT
  204.  
  205. Syntax:  EFFECT  Name  Direction  Delay
  206.  
  207. Name is the name of the effect:
  208.  
  209. WIPE      - Wipe the image.
  210. SPLIT     - Split from center out.
  211. CRUSH     - Crush from outside in.
  212. SLIDE     - Slide the image in.
  213. SAND      - Fill image like sand.
  214. DRIP      - Fill image like dripping water.
  215. EXPLODE   - Explode the image. (IN, OUT)
  216. DIAGONAL  - Diagonal from one corner to another.
  217. SPIRAL    - Spiral the image. (IN, OUT)
  218. RANDOM    - Fill with random squares (NONE)
  219.  
  220.  
  221.  
  222. Direction is the direction of the effect:
  223.  
  224. UP        - Display the image up the screen.
  225. DOWN      - Display the image down the screen.
  226. NONE      - No direction required.
  227. LEFT      - Display the image to the Left.
  228. RIGHT     - Display the image to the Right.
  229. HORIZONTAL     - Display the image Horizontally.
  230. VERTICAL  - Display the image Vertically.
  231. IN        - Display the image heading In.
  232. OUT       - Display the image heading Out.
  233.  
  234. Delay is a value used to control the speed of the effect. This
  235. time delay occurs while the image is being displayed, so the
  236. combination of the image size and the delay affect the overall
  237. speed of the display.
  238.  
  239.  
  240. END WHILE
  241.  
  242. Syntax:  END WHILE
  243.  
  244. The END WHILE statement is used to terminate a WHILE statement.
  245.  
  246.  
  247. PALETTE BLACK
  248.  
  249. Syntax:  PALETTE BLACK
  250.  
  251. This statement is used to fade a 256 color VGA image to black. It
  252. is normally used to black-out one image before showing another
  253. image that has a different color palette. 
  254.  
  255.  
  256. PALETTE RANDOMIZE
  257.  
  258. Syntax:  PALETTE RANDOMIZE Iterations
  259.  
  260. This statement is used to randomize the color palette on a 256
  261. color VGA image. It is normally used for special (psychedelic)
  262. color effects.
  263.  
  264. Iterations is the number of times to randomize the color palette.
  265.  
  266.  
  267.  
  268. PCX
  269.  
  270. Syntax:  Picture-file.PCX
  271.  
  272. Picture-file is the name of a graphics screen in PCX format. Your
  273. MVP program may contain a maximum of three PCX files. The image
  274. is displayed using the current effect.
  275.  
  276. If you have more than three PCX files then you must use the
  277. MAKEPLB program to create a Picture Library (PLB) file.
  278.  
  279. Important Note: MVP is designed to work with full-screen PCX
  280. files only!  Many PCX files are actually clip-art images. If you
  281. are having problems displaying a PCX file, then it is not the
  282. correct format. You must convert the image using the ARGUS
  283. utility provided to registered users.
  284.  
  285. PICLIB
  286.  
  287. Syntax:  Picture-library.PLB
  288.  
  289. Picture-library is the name of a PLB file created using the
  290. MAKEPLB utility program. This library is used by the SHOW command
  291. to load pictures.
  292.  
  293.  
  294. SHOW
  295.  
  296. Syntax:  SHOW Picture
  297.  
  298. Picture is the name of an image that was previously stored in a
  299. PLB file using the MAKEPLB utility. The image is displayed using
  300. the current effect.
  301.  
  302.  
  303. SLEEP
  304.  
  305. Syntax:  SLEEP Seconds
  306.  
  307. Seconds is the number of seconds to sleep. The SLEEP command only
  308. suspends the display of pictures. If music is currently playing
  309. in the background, it will continue to play.
  310.  
  311.  
  312. ROL
  313.  
  314. Syntax:  ROL Music-file.ROL
  315.  
  316. Music-file is the name of the ROL music file.
  317.  
  318.  
  319.  
  320. VIDEO
  321.  
  322. Syntax:  VIDEO  Video-display
  323.  
  324. Video-display is the type of graphics adapter required to run
  325. your MVP program. Valid types are CGA, EGA or VGA. 
  326.  
  327. An MVP program written for CGA will run on either a CGA, EGA or
  328. VGA monitor. Likewise a program written for EGA will work on
  329. either an EGA or VGA monitor, but not a CGA monitor. A VGA
  330. program will only run on a VGA graphics monitor.
  331.  
  332. This version of MVPSHARE does not support any Super VGA video
  333. modes.
  334.  
  335.  
  336. VPLAY
  337.  
  338. Syntax:  VPLAY  Sound-file 
  339.  
  340. Sound-file is the name of a digitized sound file created using
  341. the Sound Blaster VOXKIT program. VPLAY is only supported on
  342. Sound Blaster cards.
  343.  
  344. Note:  Your system must have the program VPLAY.EXE in your
  345. directory path in order for the VPLAY command to work.
  346.  
  347. VOUT
  348.  
  349. Syntax:  VOUT Sound-file
  350.  
  351. Sound-file is the name of a digitized sound file created using
  352. the Sound Blaster VOXKIT program. VOUT is only supported on Sound
  353. Blaster cards.
  354.  
  355. Note:  Your system must have the program VOUT.EXE in your
  356. directory path in order for the VOUT command to work.
  357.  
  358. WHILE PLAYING
  359.  
  360. Syntax:  WHILE PLAYING
  361.  
  362. The WHILE PLAYING command starts a loop of commands that are
  363. executed while music is playing in the background. When the music
  364. has completed, the program will branch to the statement
  365. immediately following the END WHILE.  
  366. WHILE statements may not be nested in this release of MVP.
  367.  
  368.  
  369.  
  370.                           ERROR MESSAGES
  371.  
  372. Bank File not found - MVP was unable to open the Instrument Bank
  373. file. Check that the BANK statement specifies a valid bank file.
  374. If your program does not use a bank statement then copy
  375. STANDARD.BNK to your current directory. 
  376.  
  377. Error reading PCX file - MVP was unable to read the PCX file from
  378. disk. 
  379.  
  380. Illegal Direction - Your MVP program specified an illegal
  381. direction on the EFFECT statement. 
  382.  
  383. Illegal Effect - Your MVP program specified an illegal effect on
  384. the EFFECT statement. 
  385.  
  386. Not enough memory to load PCX file - MVP did not have enough
  387. memory to load the PCX file specified. 
  388.  
  389. Not enough memory to load Picture - MVP did not have enough
  390. memory to load the image from the picture library. 
  391.  
  392. PCX File has invalid color palette - The PCX file that you are
  393. trying to display has an invalid color table. Was it created
  394. using ARGUS? 
  395.  
  396. PCX file is not a video image - You are attempting to display a
  397. PCX file that is not a video screen image. Was it created using
  398. ARGUS? 
  399.  
  400. PCX file is not valid! - MVP was not able to decode the specified
  401. PCX file. Was it created using ARGUS? 
  402.  
  403. PCX file type is not yet supported - The video mode of the PCX
  404. image that you are trying to display is not supported by MVP. 
  405.  
  406. Picture Library not found - MVP was unable to open the picture
  407. library specified on the PICLIB statement. 
  408.  
  409. Picture was not created using ARGUS - The PCX file that your are
  410. trying to display is not supported. 
  411.  
  412. Unable to display picture - MVP was unable to display the picture
  413. specified. Do you have the correct video adapter in your system? 
  414.  
  415. Unable to load picture from library - MVP was unable to load the
  416. picture from the current picture library. Is the picture in the
  417. library? This error may also indicate that MVP is out of memory. 
  418.  
  419.  
  420.  
  421. Unable to load picture - MVP was unable to load the picture from
  422. a PCX 
  423. file. This error may also indicate that MVP is out of memory. 
  424.  
  425. Unable to play song - Generally, this error indicated that MVP
  426. was not able to locate the sound driver, or was unable to read
  427. the Bank file. 
  428.  
  429. Unable to read PCX file - MVP was unable to read the PCX file
  430. specified. Does it exist on your disk? This error may also
  431. indicates that MVP is out of memory. 
  432.  
  433.                             TRADEMARKS
  434.  
  435. MS-DOS and Windows are registered trademarks of Microsoft. 
  436. IBM-PC is a registered trademark of IBM Corporation. 
  437. MUSIC, VOICE & PICTURES is a trademark of Data Assist, Inc. 
  438. AdLib is a trademark of AdLib Inc. 
  439. Sound Blaster is a trademark of Creative Labs Inc.  
  440. GIF is a trademark of Compuserve.
  441.  
  442.  
  443.